home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / os2tools / av_133 / av.doc < prev    next >
Text File  |  1992-09-18  |  11KB  |  272 lines
  1.  
  2.                         AV (Archive Viewer)
  3.                    Copyright (c) 1992 by M. Kimes
  4.                         All rights reserved
  5.  
  6.  
  7.  
  8. AV is a 32-bit PM archive viewing, application launching, and file
  9. maintenance utility for OS/2 2.x.
  10.  
  11. For archive viewing, AV uses a plain text configuration file
  12. (ARCHIVER.BB2) to get information about how different archives look and
  13. how their corresponding archivers work.  This file is included in the AV
  14. archive and is easy to modify to add other archivers using a text
  15. editor.  As supplied, LH2, PKZIP, ZOO, ARJ (via UNARJ) and ARC are
  16. configured for you (see versions below). AV requires the OS/2 archivers
  17. to be present (on your PATH, preferably) to work.  AV is a controller
  18. program that collects data from and interchanges between you, your
  19. files, and your archivers.
  20.  
  21. AV requires that the Helv bitmapped font that came with OS/2 be
  22. installed.
  23.  
  24. AV supports file association; associating datafiles with executable
  25. files so that applications can be started by selecting data files.  AV
  26. also has OS/2 1.x-like Groups for those who might want to use it as a
  27. replacement to the Workplace Shell due to memory constrictions. Groups
  28. are limited, and the Mass Move/Copy/Delete/Manipulation and Build
  29. Archive commands are non-functional in the unregistered version of AV.
  30. You do not have to use AV for archive viewing to use the program
  31. launching and file maintenance features.
  32.  
  33.  
  34. Setting up AV:
  35. =============
  36.  
  37. To use AV, copy ARCHIVER.BB2 (if you want archive viewing capability)
  38. and AV.EXE somewhere on your PATH (or DPATH for ARCHIVER.BB2).  Type SET
  39. at a CMD.EXE command prompt and look for PATH= if you don't know what
  40. your PATH is.  Check the Command Reference under PATH, DPATH and SET if
  41. you don't have any idea what I'm talking about (hint:  d:\OS2 is always
  42. on the PATH, where d: is the drive on which you installed OS/2).
  43.  
  44. Copy AV.HLP into your HELP directory.  Type SET and look for HELP=... to
  45. find it.  If you have no idea what SET is, type VIEW CMDREF SET at an
  46. OS/2 command prompt, or look for the Command Reference in the
  47. Information folder (hint:  it's usually d:\OS2\HELP, where d: is the
  48. drive on which you installed OS/2).
  49.  
  50. The first time you run AV, click the Cfg button and set up the programs
  51. that you'll be using with AV.  If you give no Viewer, AV uses a cheap
  52. internal viewer.
  53.  
  54. As you've received AV, it's set up for the following OS/2 archivers on
  55. your PATH:
  56.  
  57. Zoo         1.51 (also seems to work with 2.1)
  58. PK(Un)Zip   1.01
  59. LH2         2.11
  60. UnArj       2.10
  61. Arc         5.12mpl
  62.  
  63.         Archiver credits:
  64.  
  65.         Zoo         --  Rahul Dhesi
  66.         Zip         --  Mark Adler, Richard B. Wales, Jean-loup Gailly
  67.                         and Kai Uwe Rommel.
  68.         Unzip       --  S. H. Smith and others / Info-ZIP
  69.         PK(UN)ZIP   --  PKWARE
  70.         Arc         --  System Enhancements Associates
  71.         Lh2         --  Peter Fitzsimmons
  72.         Arj         --  Robert K. Jung
  73.  
  74. If your archivers aren't on your PATH or if you use different archivers
  75. you will probably need to make adjustments to ARCHIVER.BB2.  There are
  76. notes in the file about how to replace PK(Un)Zip with Zip/Unzip, Arc
  77. 5.12mpl with Arc2 6.0, and UnArj 2.10 with Scott Dudley's port of UnArj
  78. 2.30.  There are general notes on how it's done if you need to set up
  79. something entirely different.  AV will also try to help you out while
  80. you're in the program if it senses something may be amiss (like you
  81. screwed up); there's a built-in archiver detail editor for quick changes
  82. and testing to the archiver details.
  83.  
  84. You can run TESTAV.EXE in the directory from which you intend to run
  85. AV.EXE to easily check a few things ahead of time.
  86.  
  87. Please do use all those Help buttons; that's what they're there for.
  88.  
  89. Warning:  Go ahead and look at AV, but if your archivers aren't those
  90. listed above, and located on your PATH, don't expect AV's archive
  91. viewing to magically work properly until you edit ARCHIVER.BB2, either
  92. internally or externally.  You can test AV out on the TEST.* archives
  93. included in the distribution archive inside archive TESTARC.ZIP; unpack
  94. them, select them, and see what happens.
  95.  
  96.  
  97. Using AV:
  98. ========
  99.  
  100. Typing AV at a command line prompt (or reasonable OS/2 facsimile, like
  101. an AV program object) will bring up AV.  You can optionally follow that
  102. with a path or filename. Examples:
  103.  
  104.   Start AV in current directory:
  105.     AV
  106.   Start AV on drive D: in directory \ARCS (note trailing backslash):
  107.     AV D:\ARCS\
  108.   Start AV on drive E: in directory \ADIR looking at ANARC.ARC:
  109.     AV E:\ARCS\ANARC.ARC
  110.  
  111. AV operates by presenting you with a few different dialogue boxes in
  112. which you can pick things to look at or do.  There's full documentation
  113. available online, so this file is brief.
  114.  
  115.  
  116. When you upgrade or add archivers:
  117. =================================
  118.  
  119. The file ARCHIVER.BB2 contains all the information AV uses to get at the
  120. guts of an archive.  ARCHIVER.BB2 has comments in it to explain how it
  121. works, how to modify it and how to add to it.  If your copy of AV seems
  122. to not be working properly (identifying files properly), chances are good
  123. that your version of an archiver isn't the same as the one for which the
  124. file was made.  You'll have to load ARCHIVER.BB2 and modify it.  Look at
  125. the bottom of ARCHIVER.BB2 for some hints on the easiest ways to do that.
  126.  
  127. Note that there are a couple of different versions of archivers floating
  128. around that have details different than those "stock" in ARCHIVER.BB2.
  129. I've made commented notes in the file where I know of differences to
  130. make it easier for you to change, and AV should let you know if it
  131. thinks you might need to tweak ARCHIVER.BB2.  Don't be afraid, crank up
  132. a text editor and fix it.
  133.  
  134. If AV thinks you've got a buggered-up archiver entry, it'll try to give
  135. you advice and help you fix it.  You'll need to refer to the notes in
  136. the ARCHIVER.BB2 that came with AV for full details, so save a copy.
  137.  
  138. Most of the time when you upgrade (as opposed to add or completely
  139. change) an archiver, you'll be able to simply select an archive of the
  140. type being upgraded, then come to the Archiver Details screen and tweak
  141. your settings.  It's even possible you'll never notice the change...
  142.  
  143.  
  144. Hints:
  145. ======
  146.  
  147. Use the Workplace to associate archive names (*.ZIP, *.LZH, etc.) with
  148. AV (right-click on AV's program object, open Settings, and look at the
  149. third page, Associations).  Then, if you double-click on an archiver
  150. object in Drives, AV will be executed.
  151.  
  152. Under Parameters on the first page (Program) of AV's program Settings,
  153. put %* so that if you drag an archive onto AV's program object it'll
  154. kick up and directly view the archive.
  155.  
  156. Use AV's association feature to associate *.TAR with a TAR archiver (no
  157. way I know of to tell they're archives by peeking at the file).  If
  158. you're a C programmer you might want to associate *.MAK files with your
  159. compiler, and *.C and *.H files with your text editor.
  160.  
  161. Set up some commonly used filemasks in advance, including those you
  162. might use for file maintenance (*.BAK, FNEWS*.*, etc.) and save them by
  163. calling up the Config dialog, checking "Save As Defaults," and clicking
  164. Okay.  You can have up to 25 masks, and masks can contain multiple
  165. entries separated by a semi-colon.
  166.  
  167.  
  168. Replacing the Workplace Shell:
  169. =============================
  170.  
  171. To use AV as your Workplace Shell (not recommended unless you're in a
  172. very tight memory situation, say less than 8mb), install as above, then
  173. change the line in your CONFIG.SYS that starts SET RUNWORKPLACE= with
  174.  
  175.  SET RUNWORKPLACE=<drive>:<directory\>AV.EXE
  176.  
  177. where <drive>:<directory> is the path to where you have AV.EXE
  178. installed. You can just REM out the old line to let you easily change
  179. your CONFIG.SYS back if AV doesn't work out as you'd like.
  180.  
  181. When AV is running as the Workplace Shell, you can use it to set a
  182. bitmap to the desktop background.  Highlight the bitmap file, then
  183. select Desktop from the Menu control.  AV calls OS/2 to set the bitmap.
  184. To get rid of the bitmap and restore the desktop to a color, highlight
  185. something besides a bitmap and select Desktop as above.
  186.  
  187.  
  188. Known bugs/features:
  189. ===================
  190.  
  191. AV doesn't handle filenames with spaces in them.  There's a limit of 500
  192. files/archive (200 for the unregistered version).  I don't like AV's
  193. Shutdown when it's running as an alternate to the Workplace Shell (safe
  194. but ugly as sin).
  195.  
  196.  
  197. Warranty:
  198. ========
  199.  
  200. Absolutely none.
  201.  
  202.  
  203. Support:
  204. =======
  205.  
  206. Registered users may send and receive Fidonet netmail, Snail mail or
  207. call the BBS with questions and answers (although, to be honest, AV is
  208. so simple help should rarely if ever be needed).  See end of document
  209. for addresses.
  210.  
  211. Unregistered users will get help as and if I get the time.  If you never
  212. bothered to edit ARCHIVER.BB2 don't bother to ask for help.
  213.  
  214.  
  215. Shareware:
  216. =========
  217.  
  218. If you like and use AV, you should send the author $25.00 US via check
  219. or money order at the address below.  If you'd like the source code,
  220. send another $50.00 US. The "registered" version doesn't have the
  221. opening popup, has working Move, Copy, Build, Groups, etc., and will
  222. probably have further enhancements by the time you register (I may not
  223. be the best programmer around, but I'm balls fast).
  224.  
  225. You may continue to use the unregistered version of AV if you're a
  226. tightwad, or just plain broke.  My intent is not to gouge you for cash,
  227. but to provide a service and sell a program.  You must register,
  228. however, to get a fully functional copy of AV.
  229.  
  230. The above prices and terms are for private individuals.  Commercial
  231. users _must_ register to use AV, and must pay $50.00 US per machine.
  232. Source code is available for commercial users; ask for pricing if you're
  233. interested.
  234.  
  235.  
  236. Copyrights and such:
  237.  
  238. Zoo         --  Rahul Dhesi
  239. Lh2         --  Peter Fitzsimmons
  240. PK(UN)ZIP   --  PKWARE
  241. Arj         --  Robert Jung
  242. Zip         --  Mark Adler, Richard B. Wales, Jean-loup Gailly
  243.                 and Kai Uwe Rommel.
  244. Unzip       --  S. H. Smith and others / Info-ZIP
  245. Fidonet     --  Tom Jennings
  246. AV          --  Mark Kimes
  247.  
  248.  
  249. History:
  250.  
  251. 1.32:
  252. o AV was user friendly before; now it's user protective.
  253. o Added checks on configured programs where possible without slowing
  254.   down AV at every turn
  255. o Added online editting of ARCHIVER.BB2 info
  256. o Added multiple filemask spec; multiple masks separated by ;
  257. o 32-bit OS/2 2.x executable now; was 16-bit
  258.  
  259. 1.33:
  260. o Added still more user protection
  261. o Added filemask storage and retrieval
  262. o Added cheap internal viewer for those who don't have a viewer
  263.   configured
  264.  
  265.  
  266.  
  267. Mark Kimes
  268. 542 Merrick
  269. Shreveport, LA  71104
  270. (318)222-3455 data
  271. Fidonet#1:380/16.0
  272.